home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / dmedia / dmTCFramesBetween.z / dmTCFramesBetween
Encoding:
Text File  |  1998-10-20  |  5.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ddddmmmmTTTTCCCCFFFFrrrraaaammmmeeeessssBBBBeeeettttwwwweeeeeeeennnn((((3333ddddmmmm))))                                  ddddmmmmTTTTCCCCFFFFrrrraaaammmmeeeessssBBBBeeeettttwwwweeeeeeeennnn((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      dmTCFramesBetween - digital media timecode mathematics
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ddddmmmm____ttttiiiimmmmeeeeccccooooddddeeee....hhhh>>>>
  13.  
  14.      DDDDMMMMssssttttaaaattttuuuussss ddddmmmmTTTTCCCCFFFFrrrraaaammmmeeeessssBBBBeeeettttwwwweeeeeeeennnn
  15.          (((( iiiinnnntttt ****rrrreeeessssuuuulllltttt,,,,
  16.            ccccoooonnnnsssstttt DDDDMMMMttttiiiimmmmeeeeccccooooddddeeee ****aaaa,,,,
  17.            ccccoooonnnnsssstttt DDDDMMMMttttiiiimmmmeeeeccccooooddddeeee ****bbbb ))))
  18.  
  19.  
  20.  
  21. TTTTYYYYPPPPEEEESSSS
  22.      _D_M_t_i_m_e_c_o_d_e   A structure containing a representation of SMPTE time code
  23.                   on which certain mathematical and utility functions can be
  24.                   performed.  Can be used with:  ddddmmmmTTTTCCCCAAAAddddddddTTTTCCCC((((3333ddddmmmm)))),
  25.                   ddddmmmmTTTTCCCCAAAAddddddddFFFFrrrraaaammmmeeeessss((((3333ddddmmmm)))), ddddmmmmTTTTCCCCTTTTooooSSSSttttrrrriiiinnnngggg((((3333ddddmmmm)))), ddddmmmmTTTTCCCCFFFFrrrroooommmmSSSSeeeeccccoooonnnnddddssss((((3333ddddmmmm)))),
  26.                   ddddmmmmTTTTCCCCTTTTooooSSSSeeeeccccoooonnnnddddssss((((3333ddddmmmm)))), ddddmmmmTTTTCCCCFFFFrrrroooommmmSSSSttttrrrriiiinnnngggg((((3333ddddmmmm)))),
  27.                   ddddmmmmTTTTCCCCFFFFrrrraaaammmmeeeessssPPPPeeeerrrrDDDDaaaayyyy((((3333ddddmmmm)))), and ddddmmmmTTTTCCCCFFFFrrrraaaammmmeeeessssBBBBeeeettttwwwweeeeeeeennnn((((3333ddddmmmm)))).  Can also
  28.                   be used with the ddddmmmmLLLLTTTTCCCC((((3333ddddmmmm)))) and ddddmmmmVVVVIIIITTTTCCCC((((3333ddddmmmm)))) routines.  See
  29.                   also DDDDMMMMttttiiiimmmmeeeeccccooooddddeeee((((3333ddddmmmm)))).
  30.  
  31.  
  32. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  33.      _r_e_s_u_l_t The result of calculating the difference (b-a), measured
  34.               in frames.
  35.  
  36.  
  37.      _a, _b     The two operands of the differencing operation.
  38.  
  39.  
  40. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  41.      ddddmmmmFFFFrrrraaaammmmeeeessssBBBBeeeettttwwwweeeeeeeennnn is used to determine the number of frames between two
  42.      timecodes. It returns (b - a), as measured in frames.  The result of the
  43.      difference operation may be negative; this is _n_o_t an error condition.
  44.  
  45.      Note that the operands _a and _b must have the same _t_c__t_y_p_e as each other.
  46.  
  47.  
  48. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  49.      If a DDDDMMMMttttiiiimmmmeeeeccccooooddddeeee operand (_a or _b) contains an illegal timecode value
  50.      (e.g., a negative entry, invalid frame number, etc.), these functions
  51.      will return DM_FAILURE, and the contents of _r_e_s_u_l_t will be undefined.
  52.  
  53.      If the _t_c__t_y_p_e's of _a and _b do not match, ddddmmmmTTTTCCCCFFFFrrrraaaammmmeeeessssBBBBeeeettttwwwweeeeeeeennnn will return
  54.      DM_FAILURE, and the contents of _r_e_s_u_l_t will be undefined.
  55.  
  56.      ddddmmmmTTTTCCCCFFFFrrrraaaammmmeeeessssBBBBeeeettttwwwweeeeeeeennnn returns DM_SUCCESS upon successful completion of the
  57.      subtraction operation.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddmmmmTTTTCCCCFFFFrrrraaaammmmeeeessssBBBBeeeettttwwwweeeeeeeennnn((((3333ddddmmmm))))                                  ddddmmmmTTTTCCCCFFFFrrrraaaammmmeeeessssBBBBeeeettttwwwweeeeeeeennnn((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      dmTCFromSeconds(3dm), dmTCToSeconds(3dm), dmTCFromString(3dm),
  76.      dmTCFromString(3dm), dmTCFramesPerDay(3dm), dmTCFramesBetween(3dm),
  77.      dmLTC(3dm), dmVITC(3dm)
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.